home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / UTILREEN / BAKSCROL.LZH / BACKSCRL.DOC < prev   
Text File  |  1984-09-05  |  13KB  |  405 lines

  1.         ---------------------------------------------------             
  2.                       Back Scroll! Version 6.4
  3.         ---------------------------------------------------
  4.  
  5.                A Bi-directional Scrolling Utility for 
  6.                      the IBM Personal Computer
  7.  
  8.                      By Karlton & Kendrick Kam 
  9.  
  10.     Copyright (c) 1983 by The Kampro Group. All rights reserved.
  11.  
  12.  
  13.  
  14.      Back Scroll!, a product of The Kampro Group, is currently
  15. distributed as User Supported Software.  With a few restrictions, 
  16. this allows Back Scroll!, although copyrighted, to be freely copied 
  17. and distributed.
  18.  
  19.      First, this product must be copied and distributed as a 
  20. complete package.  This includes both the Back Scroll! program 
  21. (BACKSCRL.COM) and this documentation file (BACKSCRL.DOC).      
  22.  
  23.      Second, Back Scroll! is copyrighted and may not be distributed 
  24. if altered or modified in any way. 
  25.  
  26.      Third, no fee is to be charged for copying or distributing
  27. Back Scroll! without the written permission of The Kampro Group.
  28.  
  29.      In short, Back Scroll! may be copied and distributed to 
  30. anyone who wishes it as long as it is a complete unmodified
  31. package including the program and documentation and no fee is 
  32. charged. In turn, The Kampro Group is requesting a  small 
  33. contribution. About $20.00 is suggested but please contribute 
  34. whatever you feel Back Scroll! is worth. Your contributions will
  35. help offset development costs by The Kampro Group and thus assure 
  36. future updates and products. Also, registered users of Back Scroll 
  37. will be placed on a mailing list for future notification. Even if 
  38. you don't feel that Back Scroll! merits a contribution, please 
  39. continue to copy and share this program with others. 
  40.  
  41.      The Kampro Group welcomes any ideas and suggestions for future
  42. versions and will appreciate any comments regarding Back Scroll! or
  43. any of its software. 
  44.  
  45.  
  46.                                   The Kampro Group
  47.                                   Post Office Box 90654
  48.                                   Honolulu, Hawaii  96835
  49.  
  50.  
  51.  
  52. Introduction:
  53. -------------
  54.  
  55.      Back Scroll! is a bi-directional scrolling utility. 
  56. Once activated, Back Scroll! will buffer the screen scrolling
  57. so that the user may recall, with a few simple keystrokes, data 
  58. that has previously been scrolled off the screen .  The user 
  59. may either scroll by line or by page through Back Scroll!'s 
  60. buffer. In addition, Back Scroll!'s printer commands allow the 
  61. user to select and print any data that is currently in the buffer.
  62.  
  63.      When Back Scroll! is loaded, it becomes an extension to DOS 
  64. and from then on will be transparent to the user and most programs.
  65. The activation of Back Scroll!, once loaded, can be done at any 
  66. time without any danger to the current operation. When entering 
  67. and exiting Back Scroll!, the current display screen will be
  68. saved and restored so that the user may continue without any 
  69. interference.    
  70.  
  71. Note: Back Scroll! will only support the eighty column text display
  72. mode of either the color or monochrome display card. Unpredictable 
  73. results may occur when Back Scroll! is toggled while in either the 
  74. forty column mode or in any graphics mode.  
  75.  
  76.  
  77.  
  78. Installation:
  79. -------------
  80.  
  81.      When using Back Scroll!, one must remember that since the 
  82. screen scrolling must be buffered in memory, a certain amount 
  83. must be set aside for it. Specifically, Back Scroll! when loaded 
  84. and running, requires approximately 6700 bytes of memory. Another 
  85. 2000 bytes are needed per screen of buffer. It is the screen 
  86. buffer memory that will take the most memory and if you are not 
  87. careful, may cause some problems in systems with minimal memory.
  88. The maximum number of screens is set at 28 or about 56000 bytes. 
  89. Back Scroll! will default to 4 screens, or 8000 bytes, plus 6700
  90. more for the program itself for a total overhead of about 14700
  91. bytes. 
  92.  
  93.      The installation of Back Scroll! is simple in that the program
  94. only needs to be copied onto a working disk.  Once installed the
  95. program is called as follows:
  96.    
  97.  
  98.                    BACKSCRL,Parm1,Parm2 
  99.  
  100.      
  101.      Where "Parm1" may be substituted with a number between 1 and 28
  102. to specify the number of screen pages. Remember, Back Scroll! will 
  103. take up between 8000 and 58000 bytes of system memory depending on
  104. the amount chosen. Again, the default is set at 4 screen pages or 
  105. about 14700 bytes of memory.
  106.  
  107.      "parm2" may be substituted with a number between 1 and 25 and 
  108. will specify the numbers of lines Back Scroll! will page up and down
  109. through its buffer. The default is set at 25 lines or a full screen 
  110. but you may wish to change it.
  111.  
  112.     
  113.                 
  114. Operations:
  115. -----------
  116.  
  117.      The operation of Back Scroll! is easy and can be done in a 
  118. few simple steps. 
  119.  
  120. First, Back Scroll! must be called with the proper parameters.
  121. This can be done by entering this command at the DOS prompt:
  122.  
  123.                    BACKSCRL,parm1,parm2
  124.  
  125. And depressing the return key.
  126.  
  127. If no parameters are given, Back Scroll! will create a 4 screen 
  128. buffer with a 25 line page up and page down rate. The size of 
  129. Back Scroll! will be about 14700 bytes long but may be changed as 
  130. noted in the installation section by simply specifying the parameters.
  131.  
  132. Once Back Scroll! is loaded, you will be returned to the DOS prompt.
  133. Except for a reduction in system memory, you may then continue using 
  134. your computer normally. 
  135.  
  136. Second, now that Back Scroll! is an extension of DOS, it may be
  137. called up while in any program. The commands for doing this are
  138. as follows:
  139.  
  140. Control + Space Bar: These two keys are used to toggle into Back Scroll!.
  141.                      To avoid interfering with the current program,
  142.                      the keyboard will respond normally until these
  143.                      keys are pressed.  Once in Back Scroll!, The current
  144.                      operation is suspended and the display screen is
  145.                      saved. 
  146.  
  147. Control + Return:    Pressing these two keys simultaneously will 
  148.                      "take a picture" of the current screen.
  149.                      This can be done at any time and will move the 
  150.                      entire screen into the buffer and then return the 
  151.                      user to the current task.
  152.  
  153. The following keys must be used after the "Control + Space Bar"
  154. sequence:
  155.  
  156. Home:              This key will move the cursor up one line in the
  157.                    buffer. If the cursor is at the top of the screen, 
  158.                    the screen will be scrolled down one row and the 
  159.                    top line displayed on the screen from the buffer.
  160.  
  161. End:               This is the opposite of the above key. The cursor is
  162.                    moved down or the screen is scroll up then a line
  163.                    from the buffer displayed.   
  164.  
  165. Cursor Up:         This is used to scroll up the buffer. The screen 
  166.                    will be scrolled while leaving the cursor in its
  167.                    current position on the screen.
  168.  
  169. Cursor Down:       Same as the above command except that the buffer
  170.                    is scrolled down.
  171.  
  172. Page Up:           This key will allow the buffer to be scrolled
  173.                    up at between 1 and 25 lines at a time. The 
  174.                    actual number of lines is selected when Back
  175.                    Scroll! is loaded.
  176.  
  177. Page Down:         Same as the above key except that the buffer is
  178.                    "paged" down instead.    
  179.  
  180. Minus (-):         This is the grey minus key on the right side of the
  181.                    keyboard.  After positioning the cursor, pressing
  182.                    this key will mark the beginning of the buffer to
  183.                    be printed.
  184.  
  185. Plus (+):          This is the grey plus key on the right side of the
  186.                    keyboard.  Pressing this key marks the end of the
  187.                    buffer to be printed at the current cursor position.
  188.  
  189. PrtSc:             This will cause the marked buffer to be printed
  190.                    to line printer 1. This command can be aborted
  191.                    at any time by hitting any key.
  192.  
  193. Space Bar          Either of these keys will exit Back Scroll!.  The
  194. or Return:         currently saved screen is restored and the
  195.                    suspended operation is continued. Once out of
  196.                    Back Scroll!, it can be easily called up at 
  197.                    anytime again by using the "Control + Space Bar"
  198.                    sequence.
  199.       
  200.      While using Back Scroll!, a number will appear in the upper 
  201. right corner of the screen. This is a counter and it starts from
  202. the last line that was saved into the buffer. This number will
  203. change as the user moves around the buffer and serves as a guide
  204. to the current location.
  205.  
  206.  
  207.  
  208. Customization
  209. -------------
  210.  
  211.      Back Scroll! customization notes are available to any who wishes
  212. by sending a self addressed stamped envelope to The Kampro Group.
  213. With these notes, the keys used to enter and exit Back Scroll! can be 
  214. modified to any combination of Control, Alternate, or S..........19
  215.               MULTIPLE KEY DEFINITION FILES...........................19
  216.             DISCLAIMER................................................20
  217.             PERMISSION TO COPY........................................20
  218.             THE USER-SUPPORTED CONCEPT................................21 
  219.             PROBLEMS, SUGGESTIONS, ETC................................21 
  220.  
  221.  
  222.                                         2
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.                                         3
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.                                NEWKEY INTRODUCTION
  304.  
  305.         PURPOSE
  306.              
  307.              The Newkey keyboard enhancer simplifies the entry of common 
  308.         keystroke sequences by allowing these sequences to be assigned to 
  309.         any key desired.  Once assigned to a particular key, whenever that 
  310.         key is struck the predefined sequence of keystrokes will be 
  311.         returned in place of the struck key.  For example, the alt C key 
  312.         might be defined as 'copy' and whenever alt C is struck the string 
  313.         'copy' will be returned. 
  314.  
  315.              Newkey allows customization of software packages, ready 
  316.         creation of boiler plate passages, keyboard redefinition and 
  317.         other useful purposes.  Several sample key definition files are 
  318.         included with Newkey and will be described later. 
  319.  
  320.           Newkey provides many key translation features including:
  321.  
  322.           -  Ability to define any key
  323.  
  324.           -  Variable length "pauses" during key translation
  325.  
  326.           -  Fixed length "pauses" during key translation
  327.  
  328.           -  Nested key translation 
  329.  
  330.           -  Translation bypass for native entry of defined key
  331.  
  332.           -  User defined dynamic define area length
  333.  
  334.  
  335.              Newkey1, the Newkey support program, provides many functions 
  336.         including:
  337.  
  338.           -  Saving key definitions on disk
  339.  
  340.           -  Loading key definitions from disk
  341.  
  342.           -  Merging key definitions from disk
  343.  
  344.           -  Directory display of keys with translations
  345.  
  346.           -  Individual display of key translations
  347.  
  348.           -  Newkey on/off switch
  349.  
  350.           -  Clear current key definitions
  351.  
  352.           -  Unload and reclaim memory (DOS 1.1 only)
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.                                         4
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.                                  GETTING STARTED
  373.  
  374.  
  375.         LOADING NEWKEY
  376.  
  377.         To load newkey type
  378.  
  379.                 newkey [/parameters]
  380.  
  381.         and press the enter key.  Within a second or two a full screen 
  382.         will be displayed with the message;
  383.  
  384.                 NEWKEY loaded
  385.  
  386.         at the bottom.
  387.  
  388.              When you have received this message Newkey has been loaded.  
  389.         At this stage Newkey is ready to use.  You may wish to load a 
  390.         predefined set of key translations.  To do this refer to the 
  391.         'Load File' section.
  392.  
  393.  
  394.         Newkey Parameters (optional)
  395.  
  396.         Function:  Change dynamic define area length.  
  397.  
  398.              Newkey comes with a default dynamic define area length which 
  399.         will accept up to 300 characters of new key definitions.  This 
  400.         default may be changed at run time by specifying the parameter 
  401.         '/xxxxx' when first invoking Newkey.  
  402.  
  403.              'xxxxx' is up to a 5 digit number specifying the number of 
  404.         characters which Newkey will reserve for the dynamic define area.  
  405.         Newkey will reserve tw